home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / tsi220.zip / TSI.DOC < prev    next >
Text File  |  1994-01-06  |  16KB  |  332 lines
  1.  
  2.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄    ┌──────────────────────────────────────────╖
  3.      █                    │┌─────────────────────────────────────────╨╖
  4.      █  █▀▀▀▀█ ▀▀▀█▀▀▀    ││┌─────────────────────────────────────────╨╖
  5.      █  █         █       ╘╡│┌─────────────────────────────────────────╨╖
  6.      █  █▄▄▄▄▄    █        ╘╡│ The Sound Interface v2.20 - - - - - - -  ║
  7.      █       █    █         ╘╡ Copyright (C) 1993,1994 By Roger Yarrow  ║
  8.      █  █▄▄▄▄█ ▄▄▄█▄▄▄       ╘══════════════════════════════════════════╝
  9.  
  10. ──────────────────────────────────────────────────────────────────────────────
  11.  
  12. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  13. █ Introduction █
  14. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  15. Nowadays, sound cards are a big thing.  After getting a sound card, I quickly
  16. began to accumulate VOC, MOD, CMF, WAV, and other such sound files at a rapid
  17. rate.  As a result, I created TSI.  TSI provides you with a fast, easy, and
  18. friendly menu with which to play these files.  In addition, TSI allows these
  19. files to be stored in ZIP, ARJ, or LZH files which saves a lot of disk space.
  20. All you need is a standard color monitor to use this program.  TSI has the
  21. following features...
  22.  
  23. * XMS/EMS/Disk swap for maximum memory when playing
  24. * Tagging for multiple play
  25. * Random play (new & improved!)
  26. * Mouse support
  27. * Up to 10 different configurations at the stroke of a key
  28. * Out of this world versatility - configurable for almost anything
  29.   (Even FLI or GL files!)
  30. * Support of the ZIP, ARJ, or LZH compression format (save lots of space!)
  31. * Supports up to about 1500 files in each configuration/directory!
  32.  
  33. ...and a couple other things which I've probably forgotten to mention.
  34.  
  35. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  36. █ Installation █
  37. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  38. First of all, let me tell you that I'm not the best at writing documentation
  39. so I'll try to keep it short and sweet.  We will proceed together throughout
  40. this file under the assumption that you wish to set up TSI to play WAV files
  41. with a program called WAV-PLAY.EXE in DOS.  To begin, TSI should come with the
  42. following files...
  43.  
  44. * TSI.EXE     --  The actual program
  45. * TSI.DOC     --  The file you are reading right now
  46. * FIX-CFG.EXE --  Program to update older TSI.CFG files to current version
  47. * FILE_ID.DIZ --  Description file
  48.  
  49. If you already have used a previous version of TSI, simply place FIX-CFG.EXE
  50. in the directory containing TSI.CFG and execute it.  Pick the proper option
  51. and TSI will update your configuration file to the current version's format.
  52.  
  53. Make sure you have in your AUTOEXEC.BAT a line resembling:
  54.  
  55.   SET COMSPEC = C:\COMMAND.COM
  56.  
  57. TSI reads the "COMSPEC" environment for use when executing external players.
  58.  
  59. In addition, if you wish to include TSI.EXE in your path, TSI must know where
  60. to locate its configuration file.  To do so, add to your AUTOEXEC.BAT a line
  61. similar to:
  62.  
  63.   SET TSI = C:\DOS
  64.  
  65. In place of "C:\DOS", specify the directory where the config file will be.
  66.  
  67. Now, if the file TSI.CFG is present, you should delete it, or else TSI will
  68. most likely keep giving you an error saying there weren't any files.  After
  69. deleting TSI.CFG, run "TSI".  A warning message will appear telling you TSI
  70. couldn't find a configuration file.  A window will pop up and it asks you to
  71. answer the following questions...
  72.  
  73. (Just a note: When answering these and other questions, you may use the arrow
  74. keys, home, end, insert, and delete to ease editing your input.  In addition
  75. Control-End will delete from the cursor to the end of the input string.  The
  76. editing window will scroll as you type should your input be long.)
  77.  
  78. [1] File Directory
  79. The first question asks you for the complete drive and path the files you wish
  80. TSI to play.  In our case, we might enter "C:\SOUND\WAV\" which is the
  81. fictitious location of our WAV files.  TSI will scan that directory for all
  82. files with the ".WAV" extension (or whatever extension you specify later on).
  83. In addition, the program will also scan for any file with the ".ZIP", ".ARJ",
  84. or ".LZH" extension.  Thus, if you wish, you may keep all of your files
  85. compressed in one of those formats.  If you have files stored in a ZIP, ARJ,
  86. or LZH compressed file, it must follow these rules:
  87.  
  88. * There may be only one (1) file within each ZIP, ARJ, or LZH file
  89. * The file within that archive must have the same name as the file
  90.   For example:  BLUE.WAV must be in BLUE.ZIP, BLUE.ARJ, or BLUE.LZH, depending
  91.   upon which compression method is used;  DING.WAV must be in DING.ZIP,
  92.   DING.ARJ, or DING.LZH
  93. * NOTE:  The program will scan for ANY file with the ZIP, ARJ, or LZH
  94.   extension, so make sure that only the correct files in their regular or
  95.   compressed format are stored in that directory
  96. * ANOTHER NOTE: You must have PKUNZIP.EXE, ARJ.EXE, or LHA.EXE if you wish to
  97.   use those compression programs.  TSI does NOT have any routines built into
  98.   it.  TSI executes these programs to decompress archived files.
  99. * ONE MORE NOTE: TSI's memory usage has been limited so that the sound playing
  100.   programs you run will have enough memory.  As a result, TSI will only scan
  101.   for up to about 1500 files in the specified directory.  If you have more
  102.   than 1500 or so files, you could make several directories containing A-M and
  103.   N-Z files or something like that.  REMEMBER!...TSI has 10 configurations and
  104.   switching between these directories is not a problem at all!
  105.  
  106. [2] Utility directory
  107. The second question asks us for the complete drive and path where PKUNZIP.EXE,
  108. ARJ.EXE, and LHA.EXE are located.  For example, they might be located in "C:\"
  109. or "D:\UTILS" and so on.  It is not necessary to have any of these files.  It
  110. is only required if you wish to store your files in any one of the available
  111. compressed formats.
  112.  
  113. [3] Sound Player
  114. The third question asks for the full drive and name of the program used to
  115. play the sound files.  We'll assume that our imaginary program to play WAV
  116. files is "C:\SOUND\WAV-PLAY.EXE" -- and enter it as so.  Enter whatever
  117. program you intend to use.
  118.  
  119. [4] Player Parameters
  120. This question allows us to enter any specifics that PLAYWAV might require.
  121. For example, it might need our sound card's IRQ number, so we might enter
  122. something like "/I:7".  If you don't wish to pass any parameters to the
  123. player, just leave it blank.
  124.  
  125. (TSI would execute "C:\SOUND\WAV-PLAY.EXE YOURFILE.WAV /I:7")
  126.  
  127. [5] Work Directory
  128. The work directory is the directory where any compressed files are
  129. decompressed to.  A RAMDrive is the ideal location since it speeds up
  130. operation.  Let's assume we don't have a RAMDrive, so we'll have the files
  131. decompress to "D:\TEMP".  After a file is decompressed and played, TSI will
  132. delete it for you.  MAKE SURE THERE WILL ALWAYS BE ENOUGH ROOM FOR
  133. DECOMPRESSED FILES!  If there isn't enough room, your player will give you an
  134. error that it couldn't find the specified file to play.
  135.  
  136. [6] Sound Extension
  137. This is the extension of the sound file type that your player will use.  In
  138. our case, we would enter "WAV"
  139.  
  140. [7] Quiet Mode
  141. This question is very important.  If the program you use to play your sound
  142. files has ANY output you wish to see or its output cannot be suppressed
  143. by a " > NUL" command, make sure Quiet Mode says "YES".  If the program's
  144. output can be suppressed by a " > NUL" command, you could leave it as "NO".
  145. Once in TSI, if you play a file and then TSI returns with different or weird-
  146. looking colors, changing Quiet Mode to "YES" will remedy this problem.
  147.  
  148. [8] Interrupt Timer
  149. If Quiet Mode is set to "NO" and this option is turned on, a timer will appear
  150. on screen and ATTEMPT to properly time the length of the sound file being
  151. played.  This function works for certain programs and doesn't work for other
  152. players.  For those players it doesn't work for, the timer will simply go too
  153. fast or too slow -- No harm is done.  Simply try this to see what it's like.
  154. It works especially nice for CMF, MID, and ROL files.
  155.  
  156. [9] Memory Swap
  157. If Quiet Mode is set to "YES" then TSI will swap to EMS or XMS memory if it
  158. is present or else TSI will swap to disk.  This results in maximum memory for
  159. your external players (especially MOD players).  If a disk swap file is made,
  160. it will be created by TSI and deleted after use.  If for some reason, you do
  161. not wish TSI to use the EMS/XMS/disk swap, simply change this option to "NO"
  162.  
  163. Hopefully, the above descriptions were easy enough to understand.  Below are
  164. just a couple more possible configurations for TSI that you could answer with:
  165.  
  166. [1] C:\SB\VOCS\                    [1] D:\WOW\MODULES\
  167. [2] C:\UTILS\                      [2] C:\DOS\
  168. [3] C:\SB\VPLAY.EXE                [3] D:\WOW\WOW.EXE
  169. [4]                                [4] /I:7 /H:220
  170. [5] D:\TEMP\                       [5] E:\
  171. [6] VOC                            [6] MOD
  172. [7] NO                             [7] YES
  173. [8] YES                            [8] NO
  174. [9] NO                             [9] YES
  175.  
  176. [1] C:\GRAPHICS\FLI                [1] D:\SB\TRAK\
  177. [2] C:\ZIP\                        [2] C:\PUBLIC\
  178. [3] C:\GRAPHICS\QUICKFLI.EXE       [3] D:\SB\TRAK\TRAK.EXE
  179. [4]                                [4]
  180. [5] C:\WORK\                       [5] E:\
  181. [6] FLI                            [6] MOD
  182. [7] YES                            [7] YES
  183. [8] NO                             [8] NO
  184. [9] NO                             [9] YES
  185.  
  186. The above are just a few of the possibilities of TSI -- just use a little
  187. imagination.  The configuration we first entered will be copied for all of
  188. TSI's ten possible configurations.  Once inside TSI, you can edit the other
  189. configurations at will.  For example, I have TSI set up to be able to play MOD
  190. (with 4 different players), VOC, CMF, FLI, and GL files all at the touch of a
  191. key!  One registered user said he uses TSI to view .DBF files!  The
  192. possibilites are almost endless!
  193.  
  194. When editing, you might accidently enter an incorrect directory which doesn't
  195. contain the proper files.  TSI will not let you exit the setup window when you
  196. hit ESCAPE until you remedy this situation.  If for some reason you need to
  197. abort TSI at this point, hit F10.
  198.  
  199. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  200. █ How To Use █
  201. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  202. Once setup, the program itself is quite easy to use.  By moving the mouse
  203. around, you will have control over the pointer.  If the pointer is on a file
  204. and the left button is pressed, the highlighter will jump to that file.  If
  205. the highlighter is already on that file and you click with the left button (or
  206. hit ENTER), the program will decompress the file, if necessary, and play that
  207. file using the specifications you entered.  If you press the right button or
  208. SPACEBAR, the program will tag that song, and you will see it change to a
  209. different color to show it is tagged.  To untag a song, simply press the right
  210. button (or SPACEBAR) again on a tagged song, and it will be removed from the
  211. tagged list.  In addition, you may also use the arrow keys, page up, page
  212. down, home and end to maneuver throughout the files.  Also, holding down
  213. CONTROL and clicking the left mouse button is the same as a page up.  CONTROL
  214. and the right mouse button is a page down. (Don't worry if you don't have a
  215. mouse - it doesn't matter)
  216.  
  217. Executing "TSI #" where # is a number from 1 to 10 will run TSI so that the
  218. configuration corresponding to # will be active.
  219.  
  220. At the bottom of the screen, there is a menu showing the a few more features
  221. of TSI.  Here is a _quick_ explanation of them:
  222.  
  223. [F1] Play tagged
  224. By hitting [F1], TSI will play all of the files that are tagged.  When in this
  225. mode, there is a way to abort and return back to the program.  After a file
  226. has finished playing, a little gray "help" window will pop up.  Hold down
  227. either mouse button, CONTROL, or ALT until you hear a tone from your speaker.
  228. After hearing the tone, release the mouse button (or CONTROL/ALT), and you
  229. will be brought back TSI.  This procedure is the same for Random Play.
  230.  
  231. [F2] Random play
  232. This plays files randomly until you abort.  You may pick which configurations
  233. TSI will play from.  For example, if configs 1,2,8 are highlighted, TSI will
  234. play randomly from those configurations.  '+' will select all the configs and
  235. '-' will deselect them all.  Hitting F2 twice just plays randomly from the
  236. current configuration.
  237.  
  238. [F3] Change directory
  239. This allows you to change the current directory that has been scanned.  The
  240. change is not saved to the configuration file.
  241.  
  242. [F4] Delete file
  243. This will delete the highlighted file in case you decide you don't like it.
  244. Answer [Y] or [N] to the confirmation and it will be deleted.  If a file is
  245. read-only, TSI will not delete it.
  246.  
  247. [+],[-]
  248. These two keys will tag and untag all the files.
  249.  
  250. [Alt-H] Extended
  251. The Extended key opens up a window showing a couple more things you can do
  252. within TSI.  First of all, it shows you the Titles (SEE BELOW) of the ten
  253. configurations you have set up for TSI.  It also tells you ALT-S is to change
  254. the current setup, and ALT-T to change the title of the current setup.
  255.  
  256. [Alt-T] Title
  257. This allows you to edit the title of each configuration so it is easier to
  258. distinguish them when looking at the Extended window.  Any changes made in
  259. the title of a configuration are saved automatically.
  260.  
  261. [Alt-S] Settings
  262. This brings up a window similar to the one you first encountered when setting
  263. up TSI.  Changing these answers affects the current configuration and all
  264. changes are saved automatically.
  265.  
  266. [Alt-1,2,3,4,5,6,7,8,9,0]
  267. Hitting ALT and any key from 1 to 0 (top numeric row of keyboard) will switch
  268. you through the different configurations of TSI.  Use Alt-S and Alt-T to
  269. change these to fit your needs.
  270.  
  271. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  272. █ The Future █
  273. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  274. I don't know!  I'd be glad to hear your ideas!  Other than making this
  275. documentation a little more readible (I'm not the best writer), I can't think
  276. of any major improvements upon TSI.  Send your ideas please!
  277.  
  278. ▄▄▄▄▄▄▄▄▄▄▄▄▄
  279. █ Shareware █
  280. ▀▀▀▀▀▀▀▀▀▀▀▀▀
  281. This software is Shareware. You can copy this software, and give it to anyone
  282. as long as all files are included in an unaltered state.  There is a
  283. registration fee of $5.00 (US dollars) that is required if you use this
  284. product for more than 30 days.  In addition, registration will remove the
  285. registration messages and delays that you see.  Upon registering, you will
  286. receive instructions that will place information in TSI.CFG that registers TSI
  287. in YOUR name.  This "code" will be valid for all future releases of TSI.
  288.  
  289. Send $5.00 (US dollars - no change!) with your legal name and home address to:
  290.  
  291.  Roger Yarrow
  292.  6513 Farmingdale Court
  293.  Derwood, MD  20855
  294.  
  295. (PLEASE include the version of TSI you are currently using)
  296.  
  297. NOTE: No diskette is sent, only a code that allows you to register your copy.
  298.  
  299. If you wish to contact me for any other reason, I can be reached at the
  300. following Internet e-mail address:   ryarrow@cap.gwu.edu
  301.  
  302. Registration can also be accomplished through e-mail.  Simply mail your
  303. registration fee with the necessary information as well as your Internet
  304. address, and you will receive your registration code via Internet.
  305.  
  306. ▄▄▄▄▄▄▄▄▄▄▄▄▄
  307. █ Copyright █
  308. ▀▀▀▀▀▀▀▀▀▀▀▀▀
  309. The files TSI.EXE, TSI.DOC, and FIX-CFG.EXE are copyrighted by the author.
  310. This copyright allows you to:  use the software, copy this program for anyone
  311. as long as all files are included, and to distribute this program with all of
  312. its files for no charge.
  313.  
  314. There is no warranty of any kind on this program, and the copyright owner,
  315. Roger Yarrow, is not responsible or liable for damages of any kind caused by
  316. direct or indirect use of this program.  The copyright owner is not
  317. responsible or liable for any loss or corruption of files caused by this
  318. program.  By using this software, you agree to the above.
  319.  
  320. If you have any questions concerning distribution (such as ShareWare vendors)
  321. or this copyright, feel free to contact me at the address above.
  322.  
  323. THIS PROGRAM IS SUPPLIED "AS IS".  NO WARRANTIES OF ANY KIND ARE MADE ON IT.
  324.  
  325.                                  *****
  326.  
  327. The XMS/EMS/Diskswap routines were adapted from PD routines by Thomas Wagner.
  328.  
  329.                ╔═══════════════════════════════════════╗
  330.                ║Copyright (C) 1993,1994 by Roger Yarrow║
  331.                ╚═══════════════════════════════════════╝
  332.